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The following outlines the assumptions and techniques being used in connection 
with adding enhancements and "bug" fixes to the 152000 OS software. Your 
comments and suggestions are welcome. 


ASSUMPTIONS 


ts Availability of a total of 32K of ROM configured as 16K in the Home 
Bank and 16K in the Extension Bank occupying parallel addressing 
space in Chunks O and 1. [ 


oe Maintenance of current module organization and entry addresses for 
all Global routines. 
3s Minimum movement of current code. 


4. When executing OS ROM routines, in addition to Chunks O and 1, the 
following Home Bank RAM must be enabled: : 


Chunk 2 - Display File and System Variables 
Chunk 3 - Machine Stack and OS Ram Routines or 
second Display File 
Chunk 7 - Machine Stack and OS Ram Routines 
if second Display File open 


When the ROM routines are accessed from another bank (Dock or 
Expansion), access must therefore be via: 


A. The Function Dispatcher which enables all chunks 
in the Home Bank if the address is in the Home Bank. 


B. Call to Call Bank with the Horizontal Select byte 
specifying at least the above chunks in the Home Bank. 


This implies that access to all OS ROM routines through the above 
two paths should be via an entry address in. ‘the Home ROM. 


IMPLEMENTATION TECHNIQUE ; 


te To effectively use the ROM. Extension for! adding bug fixes and 
% enhancements, a technique has been devised to minimize the bank 
Switching overhead when only the system ROM's are involved. This 
technique, which is detailed in the attachments, gives a switching 
time for a Call of approximately 100 microseconds compared to a 
minimum of approximately 700 microseconds using the Call Bank 
routine (longer if Expansion Banks are installed). In addition, it 
preserves all registers, including IX. This technique is based 
upon Assumption 4. above, and the fact that control can be passed 
between the Home ROM and Extension ROM independent from the current 
selection of Chunks 2 through 7 since disabling Chunks 0 and 1 in 

the Extension implicitly enables them in the Home Bank. 


ve The proposed method will be utilized to implement Restarts in the 
Extension Bank to pass control to the Home ROM Restart entry points 
for ERRUR, IGN SP, NXT_IS and COPY_UP, with return (if applicable) 
switching back to the Extension ROM. The other Restarts will not 
be invoked in the ROM~ Extension. The Keyboard and NMI 
interruptions are handled in the RAM if they vector into other than 
the Home ROM. 


3. Candidate subroutines for moving to the Extension Bank must exit 
via: 


A. RETURN 
B. ‘ERROR Restart 


RETURN does the necessary bank switching and adjustment of the 
stack. An ERROR Restart will switch to the Home Bank where the 
stack will be reinitialized in processing the error. 


Nested calls between banks will be possible where the above rules 
apply, e.g. code in the Extension, called from the Home Bank, can 
call routines in the Home Bank via the same switching technique as 
long aS a normal return will be made (or an ERROR Restart). This 
is similar to the technique currently used when executing the Tape 
routines. 


Code may also be “jumped to" from the Home ROM to the Extension and 
vice versa using this technique when: 


A. Control is not to be passed back, such as for 
the ERROR Restart in the Extension 


B. Return of control is by a jump to a specified 
address in the other bank, such as during initiali- 
zation. 


4. In order to add code for "bug" fixes and enhancements, as well as 
to add the new switching routines, space will be made available in 
the Home Bank by moving selected code to the Extension, but 
maintaining its entry point in the Home Bank as currently defined. 
In general, the code affected will be directly involved in either a 
“bug" fix or the addition of an enhancement, e.g. the I0-1 module 
for I/0 to the screen will have changes added to support the 
advanced video modes. This additional code will primarily be 
located in the ROM Extension and will be accessed via the proposed 
switching technique. 


Access to the CHNG VID routine in the ROM Extension via the 
Function Dispatcher or Call Bank will be implemented by providing a 
routine in:the Home ROM (CALL_VMC) which will call CHNG_VID using 
the proposed switching technique. This approach guarantees the 
selection of the necessary RAM in the Home Bank (Chunks 2, 3 and 
7). This routine will also adjust the return address to CALL BANK 
if necessary because of the movement of code between Chunks 3 and 
7. The current interface from the Dispatcher to Call_Bank will 
also be changed from: 


CALL CALL_BANK 
RET 


to 
JP CALL_BANK 


This eliminates the extra return address within the Chunk 3/7 code. 


32K ROM BANK SWITCHING ROUTINES 
CALL FROM HOME BANK TO EXTENSION BANK 


CALLER PUSH IX 
LD IX, (Ext.Adrs.) 
CALL SWCH2X 


SWCH2X CALL ENBLX 


_ ENBLX DI 
IN A, (HREXPT) 
OR X,080H 
OUT (HREXPT),A 
LD A,03H 

RET 


QUT (DKHSPT),A 
(control to Ext.) 


INFROMH EI 
POP AF 
CALL ADJUST 


ADJUST DI . 
~ EX (SP),IX 
INC SP 
INC SP 
EX (SP),IX 
INC SP 
INC SP 
EX (SP),1X 
DEC SP 
DEC SP 
DEC SP 
DEC SP 


/ 


| 
{ 


4 


AZzPw m=z=oz ze 


‘(address 
aligned) 
I 


RET (branches to | 
target rtn.) | 


PUSH AF 
DI 
XOR A 


OUT (DKHSPT),A 
(control to Home Bank) 


BKFROMX IN A, (HREXPT) 


AND A, O7FH 
OUT  (HREXPT),A 
EI 

POP AF 

RET 


(continue) 
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(address 
aligned) 


meEz2ox 2ze 


AZzrow 


- CALL FROM EXTENSION BANK TO HOME BANK 


CALLER PUSH IX 


LD IX,(Home Adrs.) 


CALL SWCH2H I 
N 
SWCH2H PUSH AF 
DI E 
XOR A X 
NOP (for-alignment) - | T 
OUT (DKHSPT),A . 
(control to Home) (address 
eA aligned) 
INFROMX IN A,(HREXPT) I 
AND A,O7FH N 
OUT (HREXPT),A 
EI H 
POP AF 0 
CALL ADJUST M 
E 
ADJUST DI 
EX (SP),IX B 
INC SP A 
INC SP N 
EX (SP),IX K 
INC SP 
INC SP 
EX (SP),IX 
DEC SP i 
DEC SP | 
DEG. Sr | 
DEC SP | 
El 
RET (branches to | 
: target rtn.) | 
PUSH AF 4 | 
CALL ENBLX i 
ENBLX ODI 
IN A, (HREXPT) 
OR A, O80H 
OUT (HREXPT),A 
LD © A,03H 
RET ff 
% OUT (DKHSPT),A y 
(control to Ext. (address) 
aligned) 
BKFROMH EI 
POP AF 
RET 


(continue) 
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GOTO EXTENSION OR HOME BANK 


FROM THE HOME BANK FROM THE EXTENSION BANK: 
USER: PUSH IX USER: PUSH IX 
JP GOTOX JP GOTOH 
GOTOX PUSH AF GOTOH Ss PUSH.” AF 
CALL ENBLX pl 
QUT  (DKHSPT),A XOR A 
(control to Ext.) — NOP 


JPFROMH 


USER : 


RESTART 
ENTRY: 


thins saoeuaee ee ember re nerrnerere 9 


(address aligned) ._ QUT  (DKHSPT),A 


(control to Home Bank) 
(address aligned) 


POP AF JPFROMX IN A, (HREXPT) 
EX (SP), 1x AND A,O7FH 
RET (branch to target adrs.) OUT (HREXPT) ,A 
POP AF 
EX (SP), 1X 
RET (branch to target 
adrs.) 


PUSH 
RST 


LD 
JP 


RESTART FROM EXTENSION BANK 


AT ENTRY TO SWCH2H HAVE 
IX, (Restart Address) 
SWCH2H STACK: 1 Orig.IX 
: 0 Orig.Return 


‘IX: Target Address 


Re by 


QUESTIONS AND CONCERNS: 


te _If the NMI interruption is to be used in some future application, 
then the above technique may not be feasible due to potential loss 
of stack contents during the ADJUST routine. We need to determine 
if the NMI will be used and, if so, whether its definition and the 
circumstances under which it can be generated are in conflict with 
this proposal. Use of the NMI interruption would also impact 
current bank switching and 1/0 operations where it is necessary to 
mask interruptions. ; . 


2. Current access to Extension ROM routines through the Dispatcher or 
Call Bank does not enable memory outside of the target . bank. 
Should entry addresses be provided in the Home Bank, as is being 
" done for CHNG VID, to insure proper RAM availability? There is an 
- additional proplem with access to“most of these routines in that 
the IX register is not passed intact from the caller. Perhaps such 
routines should simply be deleted from the Function Dispatcher 
tables. 
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